Simplify repo-consistency agent instructions by Copilot · Pull Request #63 · demaconsulting/TemplateDotNetLibrary

Copilot · 2026-03-24T01:34:37Z

The repo-consistency agent was excessively verbose, burying the actionable steps in walls of redundant explanation. Strips it down to only what matters, and ensures the agent has the tools and precision needed to operate successfully.

Description

Rewrote .github/agents/repo-consistency.agent.md to be concise and actionable:

Removed 8 sections: "When to Invoke This Agent", "Primary Responsibilities", "Template Evolution Intelligence", "Quality Gate Verification", "Cross-Agent Coordination", "Template Reference Integration", "Usage Pattern Framework", "Compliance Verification Checklist"
Added "Consistency Steps" — a 3-step numbered list replacing ~250 lines of prose:
1. Fetch the last 20 merged PRs (is:pr is:merged) from https://github.com/demaconsulting/TemplateDotNetLibrary
2. Determine intent of each PR (what changes were performed to which files)
3. Apply missing changes to this repository's files (where appropriate, with translation)
Kept "Reporting", "Don't Do These Things", and "Key Principles"
Updated tools in YAML frontmatter from [read, search, github] to [edit, read, search, github, agent]:
- Added edit — required by step 3 to apply file changes directly in the downstream repository
- Added agent — available for coordination with specialized agents where needed
Improved step 1 precision: uses explicit repository URL and GitHub search qualifiers (is:pr is:merged) so the agent can unambiguously locate and filter merged template PRs
Removed from "Don't Do These Things": Never modify downstream code directly — the agent applies changes itself
Removed from "Key Principles": Evidence-Based Recommendations and Cross-Agent Coordination — the agent performs changes directly rather than delegating

File reduced from 297 → 40 lines.

Type of Change

Bug fix (non-breaking change which fixes an issue)
New feature (non-breaking change which adds functionality)
Breaking change (fix or feature that would cause existing functionality to not work as expected)
Documentation update
Code quality improvement

Related Issues

Pre-Submission Checklist

Before submitting this pull request, ensure you have completed the following:

Build and Test

Code builds successfully: dotnet build --configuration Release
All unit tests pass: dotnet test --configuration Release
Code produces zero warnings

Code Quality

Code formatting is correct: dotnet format --verify-no-changes
New code has appropriate XML documentation comments
Static analyzer warnings have been addressed

Quality Checks

Please run the following checks before submitting:

All linters pass: ./lint.sh (Unix/macOS) or cmd /c lint.bat / ./lint.bat (Windows)

Testing

Added unit tests for new functionality
Updated existing tests if behavior changed
All tests follow the AAA (Arrange, Act, Assert) pattern
Test coverage is maintained or improved

Documentation

Updated README.md (if applicable)
Updated ARCHITECTURE.md (if applicable)
Added code examples for new features (if applicable)
Updated requirements.yaml (if applicable)

Additional Notes

Documentation-only change. No code, tests, or build configuration affected.

⚡ Quickly spin up Copilot coding agent tasks from anywhere on your macOS or Windows machine with Raycast.

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com> Agent-Logs-Url: https://github.com/demaconsulting/TemplateDotNetLibrary/sessions/bf9bf5fe-a501-4518-9ce8-bb1d6b57be10

Malcolmnixon · 2026-03-24T01:39:59Z

@copilot I would like you to review this repo-consistency agent and determine if you think there's anything missing or which could be specified more precisely to ensure it operates successfully. For example is it more likely it would be able to find the TemplateDotNetLibrary repository if it used a web-link such as https://github.com/demaconsulting/TemplateDotNetLibrary

Copilot

Pull request overview

This PR simplifies the repo-consistency agent documentation to make it more concise and action-oriented, replacing extensive prose with a short, numbered workflow while retaining reporting guidance and guardrails.

Changes:

Replaced multiple long-form sections with a new 3-step “Consistency Steps” checklist.
Removed detailed checklists/framework prose to reduce verbosity.
Kept “Reporting”, “Don’t Do These Things”, and “Key Principles”.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

.github/agents/repo-consistency.agent.md

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com> Agent-Logs-Url: https://github.com/demaconsulting/TemplateDotNetLibrary/sessions/9310ce63-c2d4-452a-804a-00a3f49b13ec

Copilot · 2026-03-24T01:42:00Z

@copilot I would like you to review this repo-consistency agent and determine if you think there's anything missing or which could be specified more precisely to ensure it operates s...

Two improvements made in 12bbb8b:

Step 1 precision: Changed "completed" → "merged" (the correct GitHub term) and added the explicit URL https://github.com/demaconsulting/TemplateDotNetLibrary so the agent can unambiguously locate the repository.

Tools: The original [read, search, github] was missing two tools needed for the agent to operate end-to-end:

edit — required by step 3 ("Apply missing changes to this repository's files")
agent — required to invoke specialized agents for implementation (as called for by "Cross-Agent Coordination" in Key Principles and "coordinate through appropriate specialized agents" in Don't Do These Things)

Updated frontmatter: tools: [edit, read, search, github, agent]

.github/agents/repo-consistency.agent.md

…directly Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com> Agent-Logs-Url: https://github.com/demaconsulting/TemplateDotNetLibrary/sessions/3cad87a8-7acf-41ec-a37e-75c34f781b30

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com> Agent-Logs-Url: https://github.com/demaconsulting/TemplateDotNetLibrary/sessions/e1fc18f1-3aff-4aca-8933-bcfbffda955a

Copilot · 2026-03-24T01:49:39Z

@copilot I would like you to review this repo-consistency agent and determine if you think there's anything missing or which could be specified more precisely to ensure it operates s...

The current file looks well-specified for reliable operation. Key precision improvements already applied: explicit URL https://github.com/demaconsulting/TemplateDotNetLibrary (57af28f also adds is:pr is:merged qualifiers so the GitHub API call is unambiguous), "merged" rather than "completed", edit tool in frontmatter so the agent can actually apply changes, and cleaned-up guardrails that no longer contradict the agent's direct-action mandate.

Initial plan

e7afcaa

Copilot AI assigned Copilot and Malcolmnixon Mar 24, 2026

Copilot started work on behalf of Malcolmnixon March 24, 2026 01:34 View session

Refactor repo-consistency agent to be more concise

b99f554

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com> Agent-Logs-Url: https://github.com/demaconsulting/TemplateDotNetLibrary/sessions/bf9bf5fe-a501-4518-9ce8-bb1d6b57be10

Copilot AI changed the title ~~[WIP] Refactor repo consistency agent for improved clarity~~ Simplify repo-consistency agent instructions Mar 24, 2026

Copilot AI requested a review from Malcolmnixon March 24, 2026 01:38

Copilot finished work on behalf of Malcolmnixon March 24, 2026 01:38

Malcolmnixon marked this pull request as ready for review March 24, 2026 01:38

Copilot AI review requested due to automatic review settings March 24, 2026 01:38

Copilot started reviewing on behalf of Malcolmnixon March 24, 2026 01:38 View session

Copilot started work on behalf of Malcolmnixon March 24, 2026 01:40 View session

Copilot AI reviewed Mar 24, 2026

View reviewed changes

.github/agents/repo-consistency.agent.md Outdated Show resolved Hide resolved

.github/agents/repo-consistency.agent.md Show resolved Hide resolved

Improve repo-consistency agent precision and tools

12bbb8b

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com> Agent-Logs-Url: https://github.com/demaconsulting/TemplateDotNetLibrary/sessions/9310ce63-c2d4-452a-804a-00a3f49b13ec

Copilot finished work on behalf of Malcolmnixon March 24, 2026 01:42

Malcolmnixon requested changes Mar 24, 2026

View reviewed changes

.github/agents/repo-consistency.agent.md Outdated Show resolved Hide resolved

.github/agents/repo-consistency.agent.md Outdated Show resolved Hide resolved

.github/agents/repo-consistency.agent.md Outdated Show resolved Hide resolved

Copilot started work on behalf of Malcolmnixon March 24, 2026 01:46 View session

Remove outdated guardrails that conflict with agent applying changes …

ff3b237

…directly Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com> Agent-Logs-Url: https://github.com/demaconsulting/TemplateDotNetLibrary/sessions/3cad87a8-7acf-41ec-a37e-75c34f781b30

Copilot AI requested a review from Malcolmnixon March 24, 2026 01:47

Copilot finished work on behalf of Malcolmnixon March 24, 2026 01:47

Copilot started work on behalf of Malcolmnixon March 24, 2026 01:48 View session

Add GitHub search qualifiers to step 1 for precision

57af28f

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com> Agent-Logs-Url: https://github.com/demaconsulting/TemplateDotNetLibrary/sessions/e1fc18f1-3aff-4aca-8933-bcfbffda955a

Copilot finished work on behalf of Malcolmnixon March 24, 2026 01:50

Malcolmnixon approved these changes Mar 24, 2026

View reviewed changes

Malcolmnixon merged commit e20bf9b into main Mar 24, 2026
6 checks passed

Malcolmnixon deleted the copilot/refactor-repo-consistency-agent branch March 24, 2026 01:59

Copilot AI mentioned this pull request Mar 24, 2026

Simplify repo-consistency agent (port from TemplateDotNetLibrary PR #63) demaconsulting/TemplateDotNetTool#72

Merged

21 tasks

Copilot AI mentioned this pull request Mar 24, 2026

Bring in TemplateDotNetLibrary PR #63: simplify repo-consistency agent demaconsulting/TestResults#127

Merged

20 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Simplify repo-consistency agent instructions#63

Simplify repo-consistency agent instructions#63
Malcolmnixon merged 5 commits intomainfrom
copilot/refactor-repo-consistency-agent

Copilot AI commented Mar 24, 2026 •

edited

Loading

Uh oh!

Malcolmnixon commented Mar 24, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Copilot AI commented Mar 24, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI commented Mar 24, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

Copilot AI commented Mar 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Type of Change

Related Issues

Pre-Submission Checklist

Build and Test

Code Quality

Quality Checks

Testing

Documentation

Additional Notes

Uh oh!

Malcolmnixon commented Mar 24, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI commented Mar 24, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI commented Mar 24, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Mar 24, 2026 •

edited

Loading